di М. Cerofolini 


A pagina 51 dell'Apple t Refe- 
rence Manual c'è un interes- 
santissimo capitolo intitolato 
"Debugging programs" .che 
parla delle possibilità offerte 
dell'Apple И per debuggare i 
programmi scritti nel linguaggio 
macchina del microprocessore 
6502. Secondo quanto descrit- 
to nel capitolo il monitor dispo- 
ne di due comandi da usare a 
questo scopo: STEP e TRACE. 
Purtroppn leggendo più atten- 
tamente si scopre una piccola 
nota a piè pagina che dice: i 
comandi STEP e TRACE non 


. sono disponibili sugli Apple do- 


tati della ROM di Autostart. Poi- 
ché la grande maggioranza de- 
gli Apple presenti in Italia ap- 
partiene a questa categoria, fi- 
tengo che la routine in linguag- 
gio macchina che mi accingo a 
presentare possa colmare un 
vuoto nei comandi del monitor. 
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La routine di single-step 
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La routine di single step pre- 
sentata è una versione legger- 
mente modificata di quella esi- 
stente sugli Apple sprovvisti 
della ROM di Autostart. La fun- 
zione di questa routine ё quella 
di decodificare, mostrare ed 
eseguire una istruzione alla vol- 
ta. II monitor mantiene in due 
locazioni di memoria in pagina 
zero un program counter (PCL 
e PCH) per le istruzioni da ese- 
guire in single-step. L'istruzione 
viene mostrata nella sua forma 
disassemblata e quindi viene 
eseguita. Dopo l'esecuzione 
dell'istruzione, il program coun- 
ter viene aggiornato per punta- 
re alla successiva istruzione da 
eseguire. La figura 1 mostra un 
esempio di cosa succede fa- 
cendo eseguire in singie step 
un pezzo della routine step pre- 
sentata. 
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75 FE JSR 
Y=D8 Р=00 S=E7 
TXA 
Р=в0 S=C6 
EEQ 
Р=Е0 S=C6 
LDA 
Р=30 5=С6 
ЭТА 
Р=30 S-Có 
DEX 
F=E0 S=C6 
EFL 
P=E0 S-Có 
RTS 
P=E0 S-Có 
JSR 


Y=D8 
07 
Y=D8 
3c 
Y=D8 
3À 
Y=D8 


Y=D8 
F9 
Y=D8 


Y=D8 
DO ЕЗ 
Y=D8 F=E0 S=C6 


Figura 1 
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Come caricare la routine 


—— —— Á— 


———À— 


. Come si usa il single step 


———— 


Per caricare la routine ci sono 
sue modi. И primo è quello di 
caricare la routine entrando nel 
monitor col comando CALL - 
151 e di scrivere in memoria a 
partire dalla locazione $803 tut- 
fi i byte che compongono la 
routine. Dopo avere scritto tutta 
la routine occorre o salvarla su 
disco о su nastro. Nel primo ca- 
so é necessario usare il со- 
mando BSAVE STEP, A$803, 
L$F3, mentre nel secondo si 
usa il comando monitor 
803.8F5W. Se la routine viene 
introdotta in quest'ultimo modo 
non potrà più essere rilocata in 
altre posizioni di memoria. 
Disponendo di un assembler è 
bene introdurre la routine in 
sorgente così, se necessario, 
sarà possibile spostare la routi- 
ne in un altro punto della me- 
moria. 


Per usare la routine di single 
step è sufficiente eseguire co- 
mie prima cosa il comando DOS 
BRUN STEP о, in mancanza del 
DOS, eseguire da monitor la 
lettura del nastro contenente la 
routine col comando 803.8F5A 
e quindi eseguire il comando 
803G. Lo scopo di questa prima 
fase è quello di caricare in me- 
moria la routine e di eseguire le 
prime istruzioni della routine 
stessa che mettono nelle loca- 
zioni di memoria $3F8 $3F9 e 
S3FA il vettore collegato al co- 
mando monitor CTRL Y. Con 
questa operazione quando da 
monitor si hatte il comando 
CTRL Y il controllo viene preso 
dalla routine STEP. Per entrare 
in single step occorre poi batte- 
re un indirizzo seguito da CTRL 
Y (ad es. 813CTRL У). A questo 
punto viene ‘eseguita l'istruzio- 








ne presente a quell'indirizzo e 
vengono mostrati i registri del 
microprocessore dopo l'esecu- 
zione della istruzione stessa. 
Qui ho inserito una modifica ri- 
spetto alla routine originale dei- 
l'Apple. Infatti invece di rientra- 
re subito in monitor dopo Гезе- 
cuzione della istruzione ho pre- 
ferito fare prima un test sui ca- 
rattere battuto sulla tastiera do- 
po l'esecuzione della 
istruzione. Se questo carattere 
è uno spazio viene eseguita l'i- 
struzione successiva, altrimenti 
$ rientra nel monitor come la 
routine di single step originale. 
In questo modo si può eseguire 
anche una specie cli TRACE te- 
nendo contemporaneamente 
premuti i tasti di spazio e di 
REPT. In ogni caso si rientra nel 
monitor quando viene incontra- 
ta una istruzione di BRK. 
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Dove inserire la routine 
di single step 
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La routine di single step, assie- 
me ad altre eventuali routine in 
linguaggio macchina, deve es- 
sere inserita in un punto protet- 
to dalla memoria, cioè in un 
punto che non venga usato da 
altri programmi quali, ad esem- 
pio, l'interprete Applesoft o In- 
teger, l'Assembler ecc. Uno dei 
punti più usati e noti per l'uso di 
piccole routine in linguaggio 
macchina è quello che va dalla , 
locazione di memoria $300 alla 
locazione di memoria $3D0. 
Questa area di memoria non 
viene usata né dall'Applesoft 
dall'integer BASIC né dal DOS 
ma ha il difetto di essere ridotta 
e di non poter contenere routi- 
ne di una certa dimensione 
quali, ad esempio, la routine di 
single step. Per chi possiede il 
DOS descriveremo un procedi- 
mento che permette di ricavare 
una area di memoria protetta e 
sicura delle dimesioni deside- 
rate. L'area viene ricavata tra il 
DOS e i file buffer (inizialmente 
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SOURCE FILC} STLF 6841320 35 ^ БЕО ХКТІ 











1 WXXXFTANXRXAXX SINGLE STEP raso 0843:29 ЗЕ 42 AND ФЕ 
2 ккжяямяжиния PER APPLE YI XXXEAXXANKNAK 0845149 14 43 EOR $$1^ 
З XOCAO NASCITA OA KOC JODCODOCIO TERRORE 0847:C9 04 44 СМР 6804 
NEXT OBJECT FILE NAME XS STEP.DEJO s849:F9 02 45 EEQ xaz 
4 ORG $903 OBAB:B1 ЗА #6 хо! LDA (Ф385, 
5x 0840:99 3C 00 — 47 ха? STA $003С,у 
8 RINIZIALIZZA. 0850:88 ав DEY 
sx IZZAZIONE PUNTATORE CTR Y DEL MONITOR овога 139 SOY 
0803:49 4 р S2: 5 
HIE EM Eid tane, 0856140 3C 00 51 ЧИР $0896 
ОВОВ:А? 13 10 LDA  8>STEP 995105195 зале PEL 
„f овол:вр r9 ез 11 STA $329 НН 23 РСА 
0H0D:A9 08 12 іра  4«STEP 2s Aet 
овог:ар FA оз 13 STA ФЗҒА 55 ASL А 
14 RTS 56 ASL А 
Ii 0640:30 03 El ERI Enea 
16 XINIZIO SINGLE STEF COME VECCHIO APPLE II 0652156 FE 03 59 JMP  ($03FE) 
75 ТЕ 38 STEP JSR $FE7S iCARICA РСН PCL MBA aT PEU Ca RA O 
Db FB 19 JSR €F8D0 i 
H4 I 0859:68 42 FLA 
УЕ 2 Pa Met ; 3A 53 STA өза 
2 ЭН 4^ PLA : 
20 23 STA $20 ЭВ e BIA Rae 
E 23 Е 20 82 ев 66 NERK JSR ағвар 
Eo 98 25 XOINIT LDA INITEL-1rX o no pe FA ISR Rener i 
ac 26 STA $36,Х | 
22 НЫ ail 69 XRTI ме 
sa 28 BNE XOINIT РА 7 РРР 
за 29 LDA (S3ArX) TIDETSC PR 
42 30 BEQ XERK эа 75 БТА $34 
2F 21 LOY s2F 987F168 74 PLA 
32 СИР #420 
z E Pe KIER 9880:05 ЗВ 75 PCINC2 STA $38 
pH 23 Mo UA ОВ92:А5 2F 76 PCINC3 LOA $22 
s fai FERMA 0884:20 55 F9 77 JSR $2956 
4C зь СНР 4640 068718439 78 ET ob 
È i ge ин iam EE ora 
Hr pa Ea [zd Ho * 0880:20 54 F9 82 JSR $F954 
003ғ:1С9 '  0890:6^ 83 TAX 
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ЕВЕ CIANI DITA I RITA 











0891:98 84 тта 
0892348 gu FHA 
$873: ВА 86 тха 
0894148 97 РНА 
3995140 07 es LDY 9102 
9092:18 89 ХОР tuc 
OUSBIB1 ЗА 90 XJMFAT LDA — ($360 vY 
0096:6A 91 тах 
085Е:88 92 CEY 
909С:61 ЗА 93 LDA  (43A)+Y 
009E:86 3E 94 SIX 496 
0820385 ЗА 95 NEMPCL $ТА $ЭА 
Qga2:60 ГЗ 96 CCS ХЈМР 
0044:45 2D 97 RTMJMP LDA %20 
вваа:в 98 РНА 
9847:A3 2С bad LOA %2С 
0869148 100 FHA 
REGDSP JSR $FDBE 
&CDSP1 LDA 4645 
STA $40 
LOA #600 
STA $41 
LOX ФЕВ 
ROSPI LDA €$*^0 
JSR $FDED 
LDA  $FAIE»X 
OBEI 8 ED FD 219 JSR $FDED 
06С21А9 ED 111 LDA 4460 
98C4:20 ED FD 112 JSk $FOED 
aa . 113 LDA  $4A,X 
DA ҒО 114 JSR *FDDA 
115 INK 
ЕВ 116 Фит ROSPI 
bc FO 117 JSR $FDOC 
nd 118 СНР 8SA0 
03 119 ENE RETURN 
13 08 120 ЧМР STEP 
121 RETURN RTS 
122 BRANCH CL. 
n 123 toY 4601 
3A 124 LDA ($30)«Y 
56 r9 125 JSR $7756 
ЗА 126 STA ЗА 
12 YYA 
128 SEC 
8 129 BCS РСІМС2 
aA FF 130 NERNCH JSR РЕЗА 
131 SEC 
94 332 BCS РСІМСЭ 
133 хмІТЕА NOP 
134 МОР 
0870:4С EB 08 235 JMP NERNCH 
$6r3:14C DA 08 136 ЈАР ERANCH 


ких SUCCESSFUL. ASSEMELY: NO ERRORS 


Errata Corrige 


3) usati dal DOS stesso. | Ме 
buffer sono localizzati da un 
pointer posto nelle locazioni 
$9000 e $9D01. Una routine 
9,005 posta nella locazione 
!3A7D4;usa questo pointer e il 
valore di MAXFILES (SAA57) 
per costruire i fite buffer. Quello 
che è necessario fare è cam- 
biare l'indirizzo a $9000 e 
$9001 e chiamare la routine a 
$A7D3. Se ad esempio si vuole 
creare una zona sicura di $200 
(512 decimale) byle, occorre 
cambiare il valore contenuto in 
$9000, $9001 da $9CD3 a 
$9AD3 ($9CD3 - $200) e chia- 
mare la routine $А705. A que- 
sto punto il valore di HIMEN 
passa automaticamente da 
$9600 а $9400, i buffer Ча, 
$9400 а $9AFF, l'area protetta - 
va da $9800 а S9CFF mentre il 
DOS rimane infatto da $9000 a 
SBFFF. 
Ciò può essere fatto facilmente 
anche da BASIC nel modo se- 
guente: 


90 PG = 2: REM 2PAGINE DA 
256 BYTES 
100 POKE 40192, PEEK 
(40192) -PG 
110 CALL 42964 


Figura 2 









TEXT {$ HGR i HOME 


КЕМ ---- IMPOSTAZIONE VALORI INIZIALI -- 


ES = 0: REM DEVIATORE SCRITTURA O MOVIMENTO 








dove PG è il numero di pagine 
(da 256 byte) che si vogliono 
riservare. La zona di memoria 
protetta va dall'indirizzo 39680 
all'indirizzo 40191. Queste due 
righe BASIC possono essere 
poste nel programma HELLO 
che parte al boot del dischetto 
о, comunque, prima di caricare 
le routine in linguaggio macchi- 
na che interessano. Se si prefe- 
risce, sì può inizializzare un di- 
schetto slave dopo aver ese- 
guito queste operazioni otte- 
nendo un DOS che automati- 
camente riserva i byte deside- 
rati al momento del boot. Da 
notare, infine, che tutti gli indi- 
rizzi indicati si riferiscono ad un 
Apple provvisto di una memoria 
da 48 Kbyte. 
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Nell'articolo relativo alla costruzione della tavoletta grafica 
pubblicato nel numero 25 di Bit sono apparsi alcuni errori. И 
programma pubblicato è quello di taratura della tavoletta e non 
quello che permette di effettuare i disegni mentre il programma 
in linguaggio macchina di cui parla l'articolo è la versione 
oggetto del programma pubblicato. Questa è stata ottenuta per 
mezzo del compilatore Hayden. Non è stato invece pubblicato il 
programma che permette di effettuare i disegni con la tavoletta 
e che sfrutta i coefficienti ditaratura ottenuti col programma già 
presentato. Un altro errore è stato commesso nella figura 2 che 
illustra й principio di funzionamento dei vari componenti del 
sistema: l'angolo beta non arriva fino all'asse verticale ma si 
ferma sul segmento indicato come “vettore”. Infine nell'articolo 
si consiglia di suddividere il piano millimetrato in settori di 10 
gradi mentre in realtà nel prototipo fotografato la suddivisione & 
in settori di 5 gradi. Con questo speriamo di aver chiarito tutti i 
dubbi ma desideriamo sottolineare che l'articolo dovrebbe ser- 
vire a stimolare la fantasia e l'inventiva dei lettori affinchè 
trovino altri modi per tarare ed utilizzare la tavoletta. Un'ultima 
notizia. È allo studio una routine che dovrebbe permettere di 
aumentare notevolmente la precisione della tavoletla e, non 
appena ullimata, verrà presentata sulle pagine di Bit. 
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2 

3 RID = 300: КЕМ COEFICENTE EMPIRICO 
4 

6 


: КЕМ PDL DELL'ORIGINE 

7 S = 11 REM POL DELLO SNODO 

10 D$ = CHR$ (4) 

15 REM ---- LETTURA COEFFICENTI DI TARATURA -7-7 
20 PRINT 0%;°КЕАО COEFFICENTI* 

30 INFUT K1rK2:K35KA KS КЕК КВ, KOH KOKAKE 
40 PRINT D$;'CLOSE* 

45 REM ---- INZIO LOOP PRINCIPALE ------777 
$0 IF PEEK ( ~ 15384) < 128 THEN 55 

91 POKE - 16348,0 

$2 IF €S = 0 THEN ES = GOTO 55 

53 IF ES = 1 THEN ES = 0: GOTO 55 





















































55 X = PDL (SY 
60 R KS 4 КБ X X + KZ X X X + KB Xx X X X* X 
70 Е K9 + KO x X + KA x X x X + KE x XxXxX 
80 X FDL (0) 
90 я KI + охх + K3 OX XX Xo + KACX X X X X 








A+B 

(А - INY (A / 340) x 360) x 3,1415927 / 180 
INT (кож COS (M) + .5) 

INT (Rx SIN (M) + .5) 

Y + 330:Х = X + 190 

Y x 180 / RIDiY = 179 - Y 

136 X = X x 180 / RID 

140 IF SW = 1 THEN 200; КЕМ DEVIATORE PRIMO FUNTO 

D = X:YD = Y 

‚1 THEN  HPLOT XDrYD TO XY 

= Y 
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